Implementation class for DataDrivenExclusiveActivityHostConcept and ExclusiveActivityHostConcept. More...

#include <kanzi/ui/node/concept/activity/data_driven_exclusive_activity_host_impl.hpp>

Inheritance diagram for kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >:

Public Member Functions
const Node *	getNode () const override
	ExclusiveActivityHostConcept::getNode const implementation.

Node *	getNode () override
	ExclusiveActivityHostConcept::getNode implementation.

void	initialize ()
	Initialize with internal activities factory.

Public Member Functions inherited from kanzi::ExclusiveActivityHostBaseImpl< TBaseClass, TDerivedClass >
void	onFinishedExclusiveDeactivatingAnimationInternal (const ActivityConcept::StatusChangedInternalMessageArguments &args)
	Message handler for FinishedExclusiveDeactivatingAnimationInternal message.

void	onFinishedParallelActivatingAnimationInternal (const ActivityConcept::StatusChangedInternalMessageArguments &args)
	Message handler for FinishedParallelActivatingAnimationInternal message.

void	onFinishedParallelDeactivatingAnimationInternal (const ActivityConcept::StatusChangedInternalMessageArguments &args)
	Message handler for FinishedParallelDeactivatingAnimationInternal message.

NodeSharedPtr	onPrefabLoaded (PrefabTemplateSharedPtr prefabTemplate, string_view activityName) override
	ExclusiveActivityHostConcept::onPrefabLoaded implementation.

void	setActivationModifier (string_view activityName, BindingTokenWeakPtr weakModifier) override
	ActivityHostConcept::setActivationModifier implementation.

Public Member Functions inherited from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >
void	deserialize (string_view data) override
	ActivityElement::deserialize implementation.

NodeSharedPtr	findHiddenActivity (string_view activityName) const override
	ActivityHostConcept::findHiddenActivity implementation.

void	notifyChildrenNodeTreeAvailable () override
	ActivityElement::notifyChildrenNodeTreeAvailable implementation.

string	serialize () override
	ActivityElement::serialize implementation.

Public Member Functions inherited from kanzi::ActivityElement
vector< NodeSharedPtr >::const_iterator	beginChildHosts () const
	Returns the begin iterator to the registered child Activity Host.

vector< NodeSharedPtr >::const_iterator	endChildHosts () const
	Returns the end iterator to the registered child Activity Host.

Node *	findChildHost (string_view hostName)
	Finds a child Activity Host by name.

vector< string >	getCommands () const
	Gets the list of commands handled by code behind of this activity element.

ActivityHistoryManager *	getHistoryManager () const
	Gets the history manager of this activity element.

ActivityElement *	getParentElement ()
	Gets the parent ActivityElement type node.

bool	isLeafActivityNode () const
	Returns whether an ActivityElement has a child Activity Host.

void	setCodeBehind (CodeBehindSharedPtr codeBehind)
	Attaches a code behind object.

void	setCodeBehind (const Metaclass *metaclass)
	Instantiates and attaches a code behind object by specifying its metaclass.

virtual	~ActivityElement ()=default
	Destructor.

Public Member Functions inherited from kanzi::ActivityHostConcept
virtual	~ActivityHostConcept ()=default
	Destructor.

Public Member Functions inherited from kanzi::ExclusiveActivityHostConcept
virtual	~ExclusiveActivityHostConcept ()=default
	Destructor.

Public Member Functions inherited from kanzi::DataDrivenExclusiveActivityHostConcept
int	getActiveActivityIndex () const
	Gets the value of the ActiveActivityIndexProperty.

ResourceSharedPtr	getActivitySource () const
	Gets the value of the ActivitySourceProperty.

string	getActivityTemplate () const
	Gets the value of the ActivityTemplateProperty.

void	setActiveActivityIndex (int value)
	Sets the value of the ActiveActivityIndexProperty.

void	setActivitySource (ResourceSharedPtr value)
	Sets the value of the ActivitySourceProperty.

void	setActivityTemplate (string_view prefabUrl)
	Sets the value of the ActivityTemplateProperty.

virtual	~DataDrivenExclusiveActivityHostConcept ()=default
	Destructor.

Static Public Member Functions
static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()
	Returns PropertyType editor info of properties of Data-Driven Exclusive Activity Host.

Static Public Member Functions inherited from kanzi::ActivityElement
static string	getFirstElement (string_view activationSequence)
	Gets the first element of the activation sequence.

static string	getRestToForward (string_view activationSequence)
	Gets the remainder of the activation sequence.

template<typename Type >
static bool	isActivityElement (const Type &object)
	Returns whether an object is an ActivityElement.

static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()

Static Public Member Functions inherited from kanzi::ActivityHostConcept
template<typename Type >
static bool	isActivityHost (const Type &object)
	Determines if an object is an ActivityHost.

static bool	isActivityHostMetaclass (const Metaclass *metaclass)
	Checks whether the given Metaclass is an ActivityHostConcept metaclass or contains it as a mixin metaclass.

static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()

Static Public Member Functions inherited from kanzi::ExclusiveActivityHostConcept
static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()
	Returns PropertyType editor info of exclusive activity concept.

Static Public Member Functions inherited from kanzi::DataDrivenExclusiveActivityHostConcept
static string	getNameForIndex (int index)
	Returns a unique name for the data Activity at the given index in the Data Source List.

static PropertyTypeEditorInfoSharedPtr	makeEditorInfo ()
	Returns PropertyType editor info of DataDrivenExclusiveActivityHostConcept.

Protected Member Functions
	DataDrivenExclusiveActivityHostImpl (Domain *domain, string_view name)
	Constructor.

optional< ActivityHostConcept::ActivityInfo >	getActivityInfo (string_view name) const override
	ExclusiveActivityHostBaseImpl::getActivityInfo implementation.

void	onActivateActivityOverride (string_view activationPath, bool resetHistory) override
	ActivityHostConcept::onActivateActivityOverride implementation.

void	onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) override
	Node::onNodePropertyChanged implementation.

NodeSharedPtr	onPrefabLoaded (PrefabTemplateSharedPtr prefabTemplate, string_view activityName) override
	ExclusiveActivityHostConcept::onPrefabLoaded implementation.

void	proceedToActiveState () override
	ExclusiveActivityHostBaseImpl::proceedToActiveState implementation.

void	proceedToInactiveState () override
	ExclusiveActivityHostBaseImpl::proceedToInactiveState implementation.

Protected Member Functions inherited from kanzi::ExclusiveActivityHostBaseImpl< TBaseClass, TDerivedClass >
void	activate (const ActivityHostConcept::ActivityInfo &activity)
	Requests the ExclusiveActivityHost to activate an Activity node.

void	activate (const ActivityHostConcept::ActivityInfo &activity, string_view activationPath)
	Requests the ExclusiveActivityHost to activate an Activity node, and to forward the activation path to activate the children of the Activity node, if the Activity node is already active or activating.

void	deactivate ()
	Requests the ExclusiveActivityHost to deactivate the currently active Activity node.

	ExclusiveActivityHostBaseImpl (Domain *domain, string_view name)
	Constructor.

vector< string >	getActivatingNames () override
	ActivityHostConcept::getActivatingNames implementation.

string	getActiveOrActivatingName () const
	Gets the currently active or activating Activity node.

vector< NodeWeakPtr >	getActiveOrAttachedActivating () override
	ActivityHostConceptImpl::getActiveOrAttachedActivating implementation.

const vector< ExclusiveActivityHostConcept::ActivityInExclusiveHostInfo > &	getActivitiesInfo () const override
	ExclusiveActivityHostConcept::getActivitiesInfo implementation.

optional< ActivityHostConcept::ActivityInfo >	getActivityInfo (string_view name) const override
	ActivityHostConceptImpl::getActivityInfo implementation.

vector< NodeWeakPtr >	getAttachedActivityNodes () override
	ActivityHostConceptImpl::getAttachedActivityNodes implementation.

const Node *	getNode () const override
	ExclusiveActivityHostConcept::getNode implementation.

Node *	getNode () override
	ExclusiveActivityHostConcept::getNode implementation.

void	initialize ()
	Initializes this exclusive activity host.

template<typename Iterator >
string	nextToActivate (Iterator iterBegin, Iterator iterEnd, string_view current, bool looping) const
	Calculates which Activity node is going to be activated if the current active Activity node deactivates.

void	notifyParentHiddenStateChanged (bool isHidden) override
	ActivityHostConcept::notifyParentHiddenStateChanged implementation.

void	onActivateActivityOverride (string_view activationPath, bool resetHistory) override
	ActivityHostConcept::onActivateActivityOverride implementation.

void	onActivityActivated (NodeSharedPtr activity, string_view prefabPath) override
	ExclusiveActivityHostConcept::onActivityActivated implementation.

void	onActivityDeactivated (NodeSharedPtr activity) override
	ExclusiveActivityHostConcept::onActivityDeactivated implementation.

void	onActivityDeactivatedAndRemoved (NodeSharedPtr activity) override
	ExclusiveActivityHostConcept::onActivityDeactivatedAndRemoved implementation.

void	onAttachedOverride () override
	ActivityElement::onAttachedOverride implementation.

void	onDetached () override
	Node::onDetached implementation.

void	onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) override
	Node::onNodePropertyChanged implementation.

void	reactivateHiddenActivity (NodeSharedPtr activityNode, bool isTarget) override
	ExclusiveActivityHostConcept::reactivateHiddenActivity implementation.

void	resolveFocusWithPolicy (Node &activityNode) override
	ActivityHostConcept::resolveFocusWithPolicy implementation.

virtual	~ExclusiveActivityHostBaseImpl ()=default
	Destructor.

Protected Member Functions inherited from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >
	ActivityHostConceptImpl (Domain *domain, string_view name)
	Constructor.

void	clearCurrentActivationTarget () const
	Clears current activation target.

void	concealActivityNode (NodeSharedPtr activityNode)
	When deactivating an Activity:

void	dismissHiddenActivity (string_view activityName)
	Removes a stored hidden persistent Activity from this Activity Host.

void	initialize ()
	Initializes this Activity Host Concept.

bool	isHiddenActivityActivationPath (string_view path)
	Returns whether the given activation path points to a hidden persistent Activity.

void	registerInParentActivityElement () final
	ActivityElement::registerInParentActivityElement implementation.

void	resolveFocusOnActivated (Node &activityNode)
	Performs the necessary operations to fix the application focus when an Activity has activated in this Activity Host.

void	unregisterInParentActivityElement () final
	ActivityElement::unregisterInParentActivityElement implementation.

virtual	~ActivityHostConceptImpl ()=default
	Destructor.

Protected Member Functions inherited from kanzi::ActivityElementImpl< TBaseClass, TDerivedClass >
	ActivityElementImpl (Domain *domain, string_view name)
	Constructor.

void	initialize ()
	Initializes the activity element.

void	onAttached () override
	Node::onAttached implementation.

void	onDetached () override
	Node::onDetached implementation.

void	onNodePropertyChanged (AbstractPropertyType propertyType, PropertyNotificationReason reason) override
	Node::onNodePropertyChanged implementation.

	~ActivityElementImpl () override=default
	Destructor.

Protected Member Functions inherited from kanzi::ActivityElement
optional< ActivityBrowserController::ActivityID >	getActivityID () const
	Gets the unique ID that is used by the implementation of the Activity Browser.

string	getPathInParent ()
	Gets the activation path of this activity element relative to its parent.

void	initialize ()
	Initializes the activity element.

bool	isRootActivityElement () const
	Returns whether an ActivityElement is the root Activity Host node of the Screen node.

void	onForceTrigger (const ActivityBrowserController::ForceTriggerMessageArguments &args)
	Message handler for ActivityBrowserController::ForceTriggerMessage.

void	onNodeInfoTreeAvailable (const ActivityBrowserController::NodeInfoTreeAvailableArguments &)
	Message handler for ActivityBrowserController::NodeInfoTreeAvailableMessage.

void	registerChildHost (string_view hostPath)
	Registers a child host in this activity element.

void	setActivityID (optional< ActivityBrowserController::ActivityID > activityID)
	Sets the unique ID that is used by the implementation of the Activity Browser.

void	unregisterChildHost (string_view hostName)
	Unregisters a child host from this activity element.

void	updateActivityBrowserProperties ()
	Triggers the Activity Browser to update the properties of the Activity Element.

Additional Inherited Members
Public Types inherited from kanzi::ActivityHostConcept
enum class	ActivationStatus { PreparingForActivation , ParallelAnimation , ExclusiveAnimation }
	Specifies possible stages for internal tracking of activation of an Activity. More...

using	ActivityInfoContainer

enum class	DeactivationStatus { ExclusiveAnimation , ParallelAnimation , WaitingForRelease }
	Specifies possible stages for internal tracking of deactivation of an Activity. More...

Public Types inherited from kanzi::ExclusiveActivityHostConcept
enum class	ExclusiveActivityHostFocusingPolicy { WhenHostHasFocus , AlwaysFocus , NeverFocus }
	Specifies the focusing policy that Kanzi applies to an activating Activity in an Exclusive Activity Host. More...

Static Public Attributes inherited from kanzi::ActivityElement
static PropertyType< bool >	AttachedProperty

static PropertyType< bool >	PreserveHistoryProperty
	Enables the preservation of Activity property values when that Activity becomes inactive.

Static Public Attributes inherited from kanzi::ActivityHostConcept
static MessageType< ActivationMessageArguments >	ActivateActivityMessage
	You can send ActivateActivity to the Activity Host to activate an Activity.

static MessageType< ActivationMessageArguments >	DeactivateActivityMessage
	You can send DeactivateActivity to the Activity Host to deactivate an Activity.

static MessageType< ActivityPrefabMessageArguments >	ActivityPrefabAttachedMessage
	An Activity Host sends this message when it attaches the prefab of the Activity that is activated.

static MessageType< ActivityPrefabMessageArguments >	ActivityPrefabDetachedMessage
	An Activity Host sends this message when it attaches the prefab of the Activity that is activated.

static MessageType< RegisterActivityElementInternalMessageArguments >	RegisterHostInternalMessage
	Internal message sent by an Activity Host to its parent Activity or Activity Host to register the Activity Host in the parent.

static MessageType< UnregisterActivityElementInternalMessageArguments >	UnregisterHostInternalMessage
	Internal message sent by an Activity Host to its parent Activity or Activity Host to unregister the Activity Host from the parent.

Static Public Attributes inherited from kanzi::ExclusiveActivityHostConcept
static MessageType< ImplicitActivityChangeRequestMessageArguments >	NavigateNextMessage
	In an Exclusive Activity Host requests the activation of the next Activity node in that Exclusive Activity Host node.

static MessageType< ImplicitActivityChangeRequestMessageArguments >	NavigatePreviousMessage
	In an Exclusive Activity Host requests the activation of the previous Activity node in that Exclusive Activity Host node.

static PropertyType< string >	ExclusiveActivityHostContentProperty
	Describes the content of an Exclusive Activity Host node.

static PropertyType< string >	ActiveActivityProperty
	The name of the child Activity node of an Exclusive Activity Host, that is either in ActivityConcept::Status::Active or in ActivityConcept::Status::Activating state.

static PropertyType< string >	ActivationPathProperty
	The activation path containing the branch of the Activity tree that is requested to be activated.

static PropertyType< ExclusiveActivityHostFocusingPolicy >	FocusOnActivatingActivityProperty
	Sets the policy that an Exclusive Activity Host uses to decide whether it tries to set focus to an activating Activity.

Static Public Attributes inherited from kanzi::DataDrivenExclusiveActivityHostConcept
static constexpr const char *	s_activeDataActivityName
	Public name which Kanzi uses to refer to the currently and exclusively active data Activity of a Data-Driven Exclusive Activity Host.

static constexpr int	s_defaultActiveActivityIndex
	The default value of the DataDrivenExclusiveActivityHostConcept::ActiveActivityIndexProperty.

static PropertyType< ResourceSharedPtr >	ActivitySourceProperty
	Sets the DataObject that provides the data for the Activities of a Data-Driven Exclusive Activity Host.

static PropertyType< string >	ActivityTemplateProperty
	Sets the prefab template that a Data-Driven Exclusive Activity Host uses for the Activities that it creates.

static PropertyType< int >	ActiveActivityIndexProperty
	The index of the active Activity in the Data-Driven Exclusive Activity Host.

Protected Attributes inherited from kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >
string	m_activationTarget
	The name of the Activity that is the candidate to be the activation target.

bool	m_deserializing
	Indicates that this Activity Host is performing property deserialization.

bool	m_hostHadFocus
	Indicates that the Activity Host had focus before it started to activate new activation target Activity.

Detailed Description

template<typename TBaseClass, typename TDerivedClass>
class kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >

Implementation class for DataDrivenExclusiveActivityHostConcept and ExclusiveActivityHostConcept.

Since: Kanzi 3.9.0

Constructor & Destructor Documentation

◆ DataDrivenExclusiveActivityHostImpl()

template<typename TBaseClass , typename TDerivedClass >

kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::DataDrivenExclusiveActivityHostImpl	(	Domain *	domain,
		string_view	name )

explicitprotected

Constructor.

Parameters

domain	The domain to which the new node belongs.
name	The name of the node.

Member Function Documentation

◆ makeEditorInfo()

template<typename TBaseClass , typename TDerivedClass >

PropertyTypeEditorInfoSharedPtr kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::makeEditorInfo ( )

static

Returns PropertyType editor info of properties of Data-Driven Exclusive Activity Host.

◆ getNode() [1/2]

template<typename TBaseClass , typename TDerivedClass >

Node * kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::getNode ( )

overridevirtual

ExclusiveActivityHostConcept::getNode implementation.

Reimplemented from kanzi::ActivityElementImpl< TBaseClass, TDerivedClass >.

◆ getNode() [2/2]

template<typename TBaseClass , typename TDerivedClass >

const Node * kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::getNode ( ) const

overridevirtual

ExclusiveActivityHostConcept::getNode const implementation.

Reimplemented from kanzi::ActivityElementImpl< TBaseClass, TDerivedClass >.

◆ initialize()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::initialize ( )

Initialize with internal activities factory.

◆ proceedToActiveState()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::proceedToActiveState ( )

overrideprotectedvirtual

ExclusiveActivityHostBaseImpl::proceedToActiveState implementation.

Reimplemented from kanzi::ExclusiveActivityHostBaseImpl< TBaseClass, TDerivedClass >.

◆ proceedToInactiveState()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::proceedToInactiveState ( )

overrideprotectedvirtual

ExclusiveActivityHostBaseImpl::proceedToInactiveState implementation.

Reimplemented from kanzi::ExclusiveActivityHostBaseImpl< TBaseClass, TDerivedClass >.

◆ getActivityInfo()

template<typename TBaseClass , typename TDerivedClass >

optional< ActivityHostConcept::ActivityInfo > kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::getActivityInfo ( string_view name ) const

overrideprotectedvirtual

ExclusiveActivityHostBaseImpl::getActivityInfo implementation.

Additional handling for the Data Source List item names.

Implements kanzi::ActivityHostConceptImpl< TBaseClass, TDerivedClass >.

◆ onNodePropertyChanged()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::onNodePropertyChanged	(	AbstractPropertyType	propertyType,
		PropertyNotificationReason	reason )

overrideprotected

Node::onNodePropertyChanged implementation.

◆ onPrefabLoaded()

template<typename TBaseClass , typename TDerivedClass >

NodeSharedPtr kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::onPrefabLoaded	(	PrefabTemplateSharedPtr	prefabTemplate,
		string_view	activityName )

overrideprotectedvirtual

ExclusiveActivityHostConcept::onPrefabLoaded implementation.

Additional preparation for the Activity nodes from the Data Source.

Implements kanzi::ExclusiveActivityHostConcept.

◆ onActivateActivityOverride()

template<typename TBaseClass , typename TDerivedClass >

void kanzi::DataDrivenExclusiveActivityHostImpl< TBaseClass, TDerivedClass >::onActivateActivityOverride	(	string_view	activationPath,
		bool	resetHistory )

overrideprotectedvirtual

ActivityHostConcept::onActivateActivityOverride implementation.

Since: Kanzi 3.9.8 added resetHistory, removed the "final" keyword, and moved to protected.

Implements kanzi::ActivityHostConcept.

The documentation for this class was generated from the following files:

kanzi/ui/node/concept/activity/data_driven_exclusive_activity_host_impl.hpp
kanzi/ui/node/concept/activity/data_driven_exclusive_activity_host_impl_private.hpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DataDrivenExclusiveActivityHostImpl()

Member Function Documentation

◆ makeEditorInfo()

◆ getNode() [1/2]

◆ getNode() [2/2]

◆ initialize()

◆ proceedToActiveState()

◆ proceedToInactiveState()

◆ getActivityInfo()

◆ onNodePropertyChanged()

◆ onPrefabLoaded()

◆ onActivateActivityOverride()